home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / varea610.zip / VAREA.DOC < prev    next >
Text File  |  1993-08-08  |  15KB  |  423 lines
  1. VBBS Area Subscriber 6.10.06
  2. ============================
  3.  
  4. Copyright Neil J Marshall 8th August 1993
  5.     TransatlanticBBS
  6.         1 @ 440 VirtualNET
  7.         Neil J Marshall @ 2:440/211 Fido
  8.  
  9.  
  10. Introduction
  11. ============
  12.  
  13. This utility simplifies the process of subscribing to and
  14. hosting networked message areas in VNET-type networks.
  15.  
  16. It works on the principle that all a SysOp would want to do
  17. to subscribe to an existing message area is to browse through
  18. the SUBSLIST, and select the ones to which you want.
  19.  
  20. Similarly, if a SysOp wants to create a new message area for
  21. the network, all that should be needed is to give the message
  22. area a Title and select the type, Secured or AutoSubscription.
  23.  
  24. VAREA should do the rest. And it does.
  25.  
  26.  
  27. Installation
  28. ============
  29.  
  30. Place the VAREA program in your main VBBS directory, and
  31. ensure you have a copy of the SUBSLIST.NET in your VBBS
  32. network directory. The SUBSLIST.NET must be in the "new"
  33. format, in other words the lines look like this:
  34.  
  35.    Area #    Host # Nodes Flow Topic
  36.    ------    ------ ----- ---- -----------
  37.     10440       440    43   55 Harpoon Forum
  38.  
  39.  
  40. Daily Maintenance
  41. =================
  42.  
  43. VAREA should be run once a day as an event, using the following
  44. command line:
  45.  
  46.     VAREA NETWORKID=# /AUTO /VERIFY /DELETE
  47.  
  48. For message areas you host, this will:
  49.  
  50. o   Process subscription requests and unsubscription requests
  51.     for any AutoSubscription message areas
  52.  
  53. o   Remove any "unknown" nodes from the subscription lists of
  54.     any Secured or AutoSubscription message areas
  55.  
  56. o   Check if you are still the host of the message area, and
  57.     if not, make a backup copy of the subscription list with
  58.     a .OLD file extension, then convert the message area
  59.     to one to which you subscribe
  60.  
  61. o   Delete incoming subscription requests to AutoSubscription
  62.     once they have been processed
  63.  
  64. For message areas to which you subscribe, this will:
  65.  
  66. o   Check if any of the message areas have changed host, and
  67.     if so send a subscription request to the new host
  68.  
  69. o   Check if any of the message areas have been deleted from
  70.     the SUBSLIST, and if so cancel your subscription to it.
  71.     VAREA does not delete the "local" message area, in case
  72.     it is popular with your callers, in which case you might
  73.     consider becoming the new host
  74.  
  75. Finally, if you are the SUBSLIST Co-ordinator for the network,
  76. This will:
  77.  
  78. o   Check if any message areas have a host that has left the
  79.     network, and if so delete the entry in the SUBSLIST
  80.  
  81. o   Process any requests to create new message areas, issue
  82.     them with area numbers, and add them to the New Areas
  83.     section at the end of the SUBSLIST
  84.  
  85. Since all VAREA's communication through the network is EMAIL,
  86. you will see messages in your mailbox from VAREA. The ones that
  87. it has processed will have the word "Done" in the message title.
  88. The only EMAILs that VAREA will not process automatically are
  89. subscription requests for Secured message areas.
  90.  
  91.  
  92. Browsing The SUBSLIST
  93. =====================
  94.  
  95. If you want to browse the SUBSLIST, use the following command
  96. line:
  97.  
  98.     VAREA NETWORKID=#
  99.  
  100. This will present you with a screen that looks like this:
  101.  
  102.   │  Type │    │Description                     │Nodes│Flow│Topic           │
  103.   │AutoReq│    │ANSI Artwork                    │     │    │Art             │
  104.   │AutoSub│    │ANSI Elite                      │   15│    │Art             │
  105.   │Secured│    │Art: Throughout History         │    2│    │Art             │
  106.   │AutoSub│Host│NAPLPS Graphics Forum           │    9│    │Art             │
  107.   │Secured│    │American BBS Association Forum  │   34│    │Bulletin Boards │
  108.   │AutoReq│    │BBS Success                     │     │    │Bulletin Boards │
  109.   │AutoReq│    │Business of BBSing              │     │    │Bulletin Boards │
  110. ->│Secured│    │Computer Underground Digest     │    4│    │Bulletin Boards │<-
  111.   │Secured│ New│InfoNET1 Q&A                    │    0│    │Bulletin Boards │
  112.   │AutoSub│    │Internet Discussion             │   60│    │Bulletin Boards │
  113.   │AutoSub│    │National SysOp's Flame Base     │   15│    │Bulletin Boards │
  114.   │AutoReq│    │On-Line Services                │     │    │Bulletin Boards │
  115.   │AutoSub│    │WWIV-Support                    │   85│    │Bulletin Boards │
  116.   │       │    │{Spacebar subscribes/drops}     │{C creates new}   {Q Quits}│
  117.  
  118. There are currently 3 types of message area in VNET-type networks:
  119.  
  120. o   AutoRequest (AutoReq) can be subscribed to by anyone in the
  121.     network. Messages spread very quickly through the network
  122.     because they do not have to go via the message area's host
  123.  
  124. o   Secured (Secured) can only be subscribed to at the discretion
  125.     of the host. Messages spread more slowly through the network
  126.     because they have to go via the message area's host
  127.  
  128. o   AutoSubscription (AutoSub) can be subscribed to by anyone
  129.     in the network. Messages spread slowly like Secured areas
  130.     because they have to go via the message area's host
  131.  
  132. Message areas are grouped into topics, so you can browse all
  133. the available areas on a particular theme in the space of a few
  134. screens.
  135.  
  136. New message areas are identified with a "New" next to the
  137. description of the area, as demonstrated on the InfoNET1 Q&A
  138. area above.
  139.  
  140. Message areas which you host are identified with a "Host" next
  141. to the description of the area, as demonstrated on the NAPLPS
  142. Graphics Forum area above.
  143.  
  144. Message areas to which you subscribe have the Description
  145. highlighted, that is shown as black on white instead of the
  146. normal white on black.
  147.  
  148. The Nodes column shows the number of BBS that subscribe to
  149. the area, and the Flow column shows the average number of
  150. messages a day that the area gets.
  151.  
  152. The -> and <- at the edges of the screen point to the message
  153. area that you are currently examining.
  154.  
  155. You may browse up and down the SUBSLIST using the arrow keys
  156. and the page up and page down keys.
  157.  
  158. When you have finished browsing the SUBSLIST, the Q key will
  159. quit VAREA and will implement any actions you have taken.
  160.  
  161.  
  162. Subscribing to Message Areas
  163. ============================
  164.  
  165. You can subscribe to the message area that the -> <- is
  166. pointing at by hitting the SPACEBAR.
  167.  
  168. You can also cancel your subscription to a message area
  169. that is highlighed by hitting the SPACEBAR.
  170.  
  171. When VAREA finishes, you will be asked to supply the following
  172. information for each message area that you have just subscribed
  173. to:
  174.  
  175.     Database Group
  176.     Maximum messages
  177.     Read Security Level
  178.     Write Security Level
  179.     Minimum Age
  180.     Access Flag
  181.     Tagline File Number
  182.     Handle/Real Name/Anonymous
  183.     Random Title File Number
  184.     QWK Conference Number
  185.     Co-SysOp/Moderator User Number
  186.     Net Validate
  187.  
  188. This information is used to set up an entry in VCONFIG,
  189. Database Configuration, Message Areas for each newly
  190. subscribed message area.
  191.  
  192. After VAREA has completed, you must always run VCONFIG,
  193. Database Configuration, Compile Network Information.
  194.  
  195. If the message area is AutoRequest, that is all that is
  196. needed to start receiving messages.
  197.  
  198. If the message area is AutoSubscription, an EMAIL will be
  199. sent to the host of the message area. On receipt of this
  200. EMAIL his copy of VAREA will add you to the subscription
  201. list and you will start to receive messages. If you check
  202. your ONELINERs you will see when the host SysOp has received
  203. the request.
  204.  
  205. If the message area is Secured, an EMAIL will be sent to
  206. he host of the message area. On receipt of this EMAIL it is
  207. up to the SysOp to decide if and when he will manually add
  208. you to the subscription list. If you check your ONELINERs
  209. you will see when the host SysOp has received the request.
  210.  
  211.  
  212. Hosting Message Areas
  213. =====================
  214.  
  215. If you want to add a new message area to the SUBSLIST, you
  216. must first decide on the Topic that the message area is to be
  217. listed in, the message area type (Secured or AutoSubscription)
  218. and the Description, which is limited to 32 characters.
  219.  
  220. Ensure that the -> <- is pointing to a message area in the same
  221. Topic as you want your new message ar